home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / util2 / rfile113.zip / RFILE.DOC < prev    next >
Text File  |  1993-03-07  |  5KB  |  116 lines

  1. RFILE   Relative FILE size                             $7.00
  2. Copyright (c) 1992 by R.P.McCormick  
  3.                       79 Rye Street
  4.                       Broad Brook, CT 06016               
  5.  
  6. Command line: RFILE [filespec] or [screenspec]
  7.  
  8. RFILE '?' or 'h' or 'H' brings up the help screen.
  9.  
  10. For registration information, see "REGINFO.TXT". 
  11.  
  12. No parameters are required on the command line, but you can type
  13. "RFILE ega" or "RFILE cga" to force it to operate in those modes.
  14. The help screen is reachable with the function key F1 while
  15. the graphics display is active.
  16.  
  17. If nothing but RFILE appears on the command line, the current 
  18. directory is examined. You can optionally enter the name of
  19. another directory. example:  RFILE B:\TEXT. Or, you could enter
  20. a "Wildcard" extension such as RFILE *.TXT, and it will list
  21. only the files with the .txt extension. 
  22. As a programmer, I find this feature useful to check the size
  23. of all the source files in the directory I am working in. 
  24. It may be full of other files with extensions like .PRG, .CFG,
  25. .OBJ, but if I have RFILE list only the .cpp files, I can see
  26. at a glance which is the largest, and may need to be split. 
  27. I like to keep them under 5 pages in length.
  28.  
  29. I wrote RFILE because the DOS command "DIR" provides only
  30. the size of each file in the current directory. I wanted
  31. something to show graphically the size of each file relative 
  32. to the other files. To give a better view of which files are 
  33. taking up too much room on the disk.
  34.  
  35. A pie chart shows the size of each file relative to
  36. the total of all files at the current level, sorted by size. 
  37. Subdirectories are ignored. 
  38. There is a list of the files to the right, with the 
  39. number of bytes in each, and a percent.
  40. If the percentage is less than 1%, it prints a dot.       
  41. If there are more file names than can be displayed in one column,
  42. a notice appears, typically "8 more..". If you want to
  43. see the names that are off screen, use the arrow keys.
  44. A bar chart shows the size of the current directory, 
  45. including only files at the current level, as a percent of the
  46. whole disk. The bar, or "thermometer" uses full clusters, which is 
  47. a measure of how much disk space is used for the files. A file 
  48. containing one byte will take up 2048 bytes on a typical hard drive.
  49.  
  50. You may be able to print the CGA screen using DOS commands if your
  51. printer is compatible. Type "GRAPHICS COLOR1" prior to using RDIR,
  52. then hit shift-PrintScreen while viewing the CGA screen. The DOS
  53. manual says this is for an "IBM Personal Computer Color Printer",
  54. but it works fine with my old Epson MX-80.
  55.  
  56. To exit from the graphic screen, use the "Esc" key.
  57.  
  58.  
  59. These are the types of directory names and filespecs I expect to see 
  60. typed on the command line after "RFILE". Any other variations may produce
  61. unexpected results. The example assumes you are currently in a directory
  62. on the C: drive named C:\TOOLS, and the B: drive is at the B:\TEXT dir.
  63.  
  64. CMD LINE        DESCRIPTION                            EXAMPLE
  65. (Nothing)       Current directory                      C:\TOOLS
  66. *.TXT           Current directory, .TXT files only     C:\TOOLS\*.TXT 
  67. C:              Current directory                      C:\TOOLS
  68. C:*.TXT         Current directory, .TXT files only     C:\TOOLS\*.TXT 
  69. C:\             Top level C:                           C:\
  70. C:\TC           As typed                               C:\TC
  71. C:\TC\*.DOC     As typed                               C:\TC\*.DOC    
  72. GRAPHICS        Current dir, GRAPHICS sub              C:\TOOLS\GRAPHICS
  73. GRAPHICS\*.DOC    "  "  "  ", .DOC files only          C:\TOOLS\GRAPHICS\*.DOC
  74. C:GRAPHICS      Current dir, GRAPHICS sub              C:\TOOLS\GRAPHICS
  75. \TC             Current drive, TC dir                  C:\TC
  76. \TC\*.DOC       All .DOC files in Current drive,TC dir C:\TC\*.DOC
  77. B:              Current B: directory                   B:\TEXT
  78. B:*.TXT         All .TXT files in current B: dir       B:\TEXT\*.TXT
  79. B:\             Top level B:                           B:\
  80. B:MISC          Current B: dir, MISC sub               B:\TEXT\MISC   
  81.  
  82.  
  83. ASP Ombudsman Statement:
  84.           ~~~~~~~~~~~~~~~~~~~~~~~~
  85. This program is produced by a member of the Association of
  86. Shareware Professionals (ASP).  ASP wants to make sure that the
  87. shareware principle works for you.  If you are unable to resolve
  88. a shareware-related problem with an ASP member by contacting the
  89. member directly, ASP may be able to help.  The ASP Ombudsman can
  90. help you resolve a dispute or problem with an ASP member, but
  91. does not provide technical support for members' products.
  92.  
  93. Please write to the ASP Ombudsman at:
  94.  
  95.              ASP Ombudsman
  96.              545 Grover Road
  97.              Muskegon, MI  49442-9427
  98.              U.S.A.
  99.  
  100. or send a CompuServe message via CompuServe MAIL to ASP Ombudsman
  101. 70007,3536.
  102.  
  103.  
  104.  
  105.                            WARRANTY
  106.  
  107. If you order a disk from me, and it arrives damaged, it will be 
  108. replaced at my expense if you notify me within 10 days of receipt.
  109.  
  110. I specifically disclaim all other warranties, expressed or implied,
  111. including but not limited to damage to hardware and/or software from
  112. the use of this product. Under no circumstances will I be liable for
  113. any damages,lost profits or incidental or consequential damages
  114. arising from your use or inability to use the program.
  115.  
  116.